home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / attmn07a.zip / english.txt < prev    next >
Text File  |  1997-08-16  |  23KB  |  456 lines
  1. --------------------[Attribute Manager V.0.71.62 beta]-----------------------
  2.  
  3. -------------[(c) 1997 Alessandro Cantatore * Team OS/2 Italy]--------------
  4.  
  5. This program is freeware and it is beta code. Anyway it should be safe and
  6. not able to cause any loss of data. You can freely use it until December the
  7. 31th 1997 or as soon as a new version will be released.
  8.  
  9. As a standard disclaimer:
  10.  
  11. Under no circumstances the author is liable for any loss or damage.
  12. The use of the program implies acceptance of the conditions stated above.
  13.  
  14. ----------------------------------------------------------------------------
  15.  
  16. What is new with this release
  17. =============================
  18.  
  19. - Bug correction: the program entered an endless loop when
  20.   no %TMP% or %TEMP% directory was specified in the config.sys
  21.   file or if the path specified was invalid.
  22. - Modified pop-up menu code. Now it will work properly
  23.   even if the mouse buttons have been swapped.
  24. - Modified bubble help. Help window will be shown as
  25.   soon as mouse is moved over a button. Bubble help
  26.   may be disabled through the preferences notebook
  27. - Modified file list box. Extended selection works
  28.   like in folders: when multiple files are selected,
  29.   clicking on an already selected file will deselect
  30.   all other files.
  31. - The Undo function, in the Edit submenu, now works.
  32. - The buttons in the Save dialog which appears when
  33.   the selection of a new file deselect previous selected
  34.   files (whose attributes have been modified) now work
  35.   as expected. The indexes of previously selected files
  36.   are stored in memory and so the previous selection
  37.   can be restored when cancelling a new selection or
  38.   file drop.
  39. - The window title is updated every time a new selection
  40.   or double click (according to the user preferences) is
  41.   performed.
  42. - When in "nobrowse" mode the window maximize button is
  43.   removed since the window height can't be resized.
  44. - Closing the application through the task list or by system
  45.   shutdown now is properly managed and a "Save/Discard/Cancel"
  46.   dialog is displayed if any attribute has been modified.
  47. - Preferences dialog now uses 8.Helv if it detects OS/2 version
  48.   2.xx or 3.
  49.  
  50.     
  51. Introduction
  52. ============
  53. The program allows to easily add, edit or delete the .SUBJECT, .COMMENTS and
  54. .KEYPHRASES extended attributes, ordinary attributes and time/date stamps of
  55. one or more files.
  56. I have a lot of archived files I downloaded from the internet and often cannot
  57. remember their content or cannot find a particular file. Attribute manager
  58. allows to add a small description (it can be as long as about 32 KB in this
  59. release) and some "Key Phrases" you can use when searching files.
  60. Even if the "Find" button is not yet operative in this release, the OS/2
  61. built-in Find utility allows file search based on the content of the
  62. "Key Phrases" extended attribute.
  63. Suppose you run a BBS and have archives of various kind of applications for
  64. different operating system, you could use various key phrases describing for
  65. example:
  66. -1) the author of the application
  67. -2) the operating system it is designed for
  68. -3) kind of application (file manager, game, etc.)
  69. -4) your evaluation (good application, useful, etc)
  70. -5) anything else
  71. This way, through the object find utility, you could automatically create
  72. folders containing all your "OS/2 text mode file managers", or all
  73. applications of your favourite software author and so on...
  74.  
  75.  
  76. Installation
  77. ============
  78. Just put it where you like and run it. It doesn't need any runtime library
  79. (i.e. DLL files) other than the operating system DLLs and won't mess with
  80. your INI files!
  81. All the informations needed by the program will be stored in its own INI
  82. file (ATTMAN.INI). Nothing will be added to OS2.INI or OS2SYS.INI.
  83. If you want to use a different INI file, you can pass its name as argument
  84. using the "P" option. The option is case insensitive and can be introduced
  85. either by "/" or by "-". So if you want to store your program preferences
  86. in "D:\PROGRAMS\MYINIFILE.INI" and open the program with the attributes
  87. of "C:\OS2\BITMAPS\*.GIF" you must type:
  88. ATTMAN -pD:\PROGRAMS\MYINIFILE.INI C:\OS2\BITMAPS\*.GIF
  89. The arguments cah have any order: the profile name can be specified either
  90. before or after the file name.
  91. You can create different program objects using different INI files. Just
  92. type in the object settings "Parameters" entry field:
  93. -pD:\PROGRAMS\MYINIFILE.INI %*
  94. (change D:\PROGRAMS\MYINIFILE.INI to the path\name of the INI file you
  95. want to use).
  96.  
  97.  
  98. Starting the program
  99. ====================
  100. You can start it from the command line, double click on its icon, or
  101. just drag a file/directory on its icon.
  102. In future I could add as option the chance to start it by the contetextual
  103. menu of any file object.
  104. You can select files or directories in the "Browse" window (click on the
  105. first button in the tool bar or select File->Select->Browse from the pop-up
  106. menu) or by opening folders on your desktop and dragging files or directories
  107. on the application title bar.
  108.  
  109.  
  110. Help
  111. ====
  112. At the moment there is no on line help. To tell the truth there are
  113. still a lot of not yet implemented features so do not wonder if some
  114. menu option or button doesn't work.
  115. If you move your mouse over a toolbar button you'll get
  116. some explanation about that button.
  117. Report and Find still do not work.
  118.  
  119.  
  120. How it works
  121. ============
  122. It is like a file dialog box: just select a file and edit the attributes.
  123. If you have changed some attribute and select a new file or directory
  124. a dialog box will ask you if you want to save or discard what you modified.
  125. Click on the Save button to avoid that.
  126. If you chosed to work with the Extended selection option (see "Preferences")
  127. you can select one or more files in the same way you do that with other
  128. WPS objects:
  129.  - swiping the mouse pointer on the "File:" list box while pressing down MB1
  130.    (mouse button one)
  131.  - clicking with MB1 while keeping the "Ctrl" key pressed down for selecting
  132.    not-contiguous files
  133.  - clicking with MB1 while keeping the "Shift" key pressed down for selecting
  134.    all files betwen the previous selection and the current selection
  135. The file specifics and attributes showed concern the topmost selected file.
  136. If you want to set the same attribute for all selected files you must click
  137. on the "Save" button in the main window. A dialog box will then be displayed
  138. to allow you to choose which attributes to set for all the selcted files.
  139. For instance if the selected files have different "comments" and you want them
  140. to share the same "key phrases" without affecting "comments" or any other
  141. attribute, you must select only the "Key phrases" check box in the "Multiple
  142. File Save" dialog.
  143. The first button on the left allows to show/hide (browse/nobrowse mode) the
  144. drive/path/file selection window. For the same purpose you can use the menu
  145. by clicking with mouse button2 anywhere in the window and selecting:
  146. File->Select->Browse.
  147.  
  148.  
  149. Preferences
  150. ===========
  151. To open the preferences notebook select from the menu:
  152. Options->General Preferences.
  153. (New options or just enabled options are introduced by "*" rather than by "-")
  154.  
  155.  
  156. [Common buttons]
  157.  
  158. - Undo:              It reverts the various buttons, entry fields, etc., in
  159.                      the current page, to their previous state.
  160.  
  161. * Default:           It reverts the various buttons, entry fields, etc., in
  162.                      the current page, to the default state.
  163.  
  164. - Help:              Not working yet.
  165.  
  166. [General Page]
  167.  
  168. - Disable logo:      allows to hide/display the startup logo.
  169.  
  170. - Enable toolbar bubble help    displays bubble help when the mouse is
  171.                      moved over a button
  172.  
  173. - Subject length:    unchecking the "Default" button you'll be able
  174.                      to specify a non default lenght (the default is
  175.                      40 characters and the maximum is 255)
  176.  
  177. - Read only mode:    If this is checked you can read the attributes, but
  178.                      cannot modify them.
  179.  
  180. * Save last path:    It will save last selected path when you close the
  181.                      application and start it from there if you double click
  182.                      on the application icon. If you start the application
  183.                      by dragging a file on its icon, it will started in
  184.                      the file path rather than the previous one.
  185.  
  186. * Font:              The button displays the font dialog. To set a new font
  187.                      you can as well drag it on a free region of the main window
  188.                      or on the window border from the font palette.
  189.  
  190. [Selection page]
  191.  
  192. - Extended file selection:     Allows to select multiple files.
  193.  
  194. - Select all files in directory:     If the program is opened by passing it
  195.                      a directory name as argument, if the "Extended selection"
  196.                      is enabled, all files contained in the directory will
  197.                      be selected.
  198.  
  199. - Single mouse click: Allows to select drive/directory/file with one mouse
  200.                      click rather than with a double click.
  201.  
  202. - Show file selection window: If checked the window is displayed in its full
  203.                      size. When it is unchecked only the attributes of the
  204.                      current file are diaplayed.
  205.  
  206. - Only directory:    If the previous checkbox is enabled the window will
  207.                      be displayed in its full size only when the argument
  208.                      of the program is a directory.
  209.  
  210. [Import page 1 of 2]
  211.  
  212. The following options haven't yet been fully tested.
  213.  
  214. * Auto import        If the currently selected file, or the first of the
  215.                      selected files, doesn't have any Subject or Comment
  216.                      description the program will look for a description.ion
  217.                      file, for file_id.diz if the current file is an archive
  218.                      of known format, or for a different kind of description
  219.                      which could be extracted by the user defined options
  220.                      importing it into the field specified in the "Import to"
  221.                      box.
  222.                      Note:
  223.                      This works only for one file even if more than one file
  224.                      are selected.
  225.                      The description is automatically saved in the EAs unless
  226.                      "View only" (see next option) or "Read only" are checked.
  227.  
  228. * View only          The imported descriptions are shown in the Subject or
  229.                      Comment fields, but aren't automatically saved in the EAs.
  230.                      If the application is not in "Read only" mode (see Preferences
  231.                      General Page) you can save the imported description in the
  232.                      EAs by clicking on the Save button in the toolbar or by
  233.                      selecting File->Save attributes from the pop-up menu.
  234.  
  235. *Import to           Sets the default field where imported descriptions are
  236.                      displayed (and saved). You can override this by selecting
  237.                      a different import target by its contextual menu: i.e.
  238.                      if you select Edit->Import from the Subject entry field
  239.                      pop-up menu descriptions will be imported there.
  240.                      Auto select lets the program look for the most suitable
  241.                      field: if the description is longer than the maximum
  242.                      Subject length (see Preferences - General Page) it will
  243.                      be imported in the Comment field. (In the next release it
  244.                      will check for line feed cahrs too).
  245.  
  246. * Default import mode    Sets the default source of file descriptions.
  247.                      When "Automatic" it will check for 4 DOS - 4 OS/2 description
  248.                      files, if it fails, will check if the file is a known archive
  249.                      type and if a suitable description is in the archive, last if
  250.                      you defined your own import program it will try to get a
  251.                      description through it.
  252.                      "Other" displays an "Open file" dialog in ordre to allow you
  253.                      to import any text file.
  254.                     
  255.                      
  256. * 4 DOS - OS/2 description file       you must specify here the name used by the
  257.                      4 DOS - 4 OS/2 for file descriptions.
  258.  
  259. * User defined       If you need to import descriptions from a particular file
  260.                      you could write a REXX script (I will include some sample
  261.                      in the future releases) or use a suitable program. The
  262.                      description will be imported from a file generated by the
  263.                      program you defined.
  264.                      "File to import:" is the name of the output file created
  265.                      by the user defined program.
  266.                      "Program:" is the executable name and must include the full
  267.                      path unless the program is in %PATH% as defined in CONFIG.SYS.
  268.                      "Parameters:" specify the parameters you need to pass to the
  269.                      program you defined. Some special characters are used:
  270.                      %d       means a temporary directory created by the application.
  271.                               The output file, as defined in "File to import:"
  272.                               must be generated here unless you specify its full
  273.                               path.
  274.                      %f       means the current file including the full path (as
  275.                               displayed in the application title bar)
  276.                      %i       means "File to import:"
  277.                      %p       means the full path of the current file
  278.                      %%       means the percent ("%") char
  279.                      Chars following "%" are case insensitive so "%D" has the same
  280.                      meaning of "%d".
  281.             
  282. [Import page 2 of 2]
  283.  
  284. * Archive type       In this box are listed all the archive extensions used by the
  285.                      program to tell if a file is a "known archive".
  286.                      You can add or remove extensions or edit the respective fields.
  287.                      The Update, Add and Remove buttons are enabled as suitable to
  288.                      avoid incorrect user operations.
  289. * Update button      Will be enabled as soon as you select an item from the
  290.                      "Archive type" list box. It allows you to edit the settings
  291.                      relative to an already listed file extension.
  292. * Add button         Allows to add data for a new type of archive file. It is
  293.                      disabled if some field is empty or the text in "New type:" is
  294.                      already listed.
  295. * Remove button      Will be enabled as soon as you select an item from the
  296.                      "Archive type" list box. It allows you to remove an "archive
  297.                      type" from the list.
  298. * New type           In this field you must specify the extension of an archive
  299.                      file (for instance "*.rar" or "*.arj", etc.).
  300. * File to import     In this field you must specify the name of the file that will
  301.                      be extracted from the archive and imported as a file
  302.                      description. It should usually be "FILE_ID.DIZ".
  303. * Program            You should specify here the unarchiver program to use with
  304.                      files whose extension is specified in "New type:".
  305.                      You must specify the executable full path unless it is in
  306.                      a directory mentioned in the CONFIG.SYS PATH statement.
  307. * Parameters         These are the parameters needed by the program you specified
  308.                      to extract "File to import:" files from file of type
  309.                      "New type:".
  310.                      See Preferences - Import page 1 of 2 for conventions about
  311.                      parameters.
  312.                      
  313. [Report page 1 of 2]
  314. The following options haven't yet been implemented.
  315.  
  316. - Auto report        Allows to generate a report with all file data and
  317.                      attributes. The report will be showed in a separate
  318.                      window. It will be possible to print it and save it
  319.                      to file. If this checkbox is selected, usually, both
  320.                      the main program window and the report window will
  321.                      be displayed. If this checkbox is unchecked it will
  322.                      always be possible to generate a Report by selecting
  323.                      the button in the toolbar of the main window or by
  324.                      selecting from the menu File->Report.
  325.  
  326. - Only directory     The report will be generated only if the argument is
  327.                      a directory.
  328.  
  329. - Show               The report window will be shown besides the application
  330.                      main window.
  331.  
  332. - Hide               The report will be generated but won't be visible.
  333.  
  334. - Show only report   Only the report window will be visible. It will be possible
  335.                      to generate directory/file report by dragging file and
  336.                      directories on the report window title bar.
  337.  
  338. - Selected files     Only the selected files will be included in the report.
  339.  
  340. - All files          All files in the current directory will be included
  341.                      in the report.
  342.  
  343. - Full Tree          All files in the current directory and, recursively,
  344.                      in all its subdirectories will be included in the
  345.                      report
  346.  
  347. [Report page 2 of 2]
  348.  
  349. - Format             The report will be formatted by the program you specify
  350.                      here (it could just be a REXX script). This way you could
  351.                      easily create DESCRIPT.ION or FILE.BBS files from subjects
  352.                      and comments EAs.
  353.  
  354. - Auto save          Generated (and formatted) reports will be saved automatically
  355.                      in a file you specify in the current directory or any other
  356.                      specified directory.
  357.  
  358. [Find page]
  359.  
  360. (it doesn't work yet) allows to specify an external program for the find function.
  361.  
  362.  
  363. Menu
  364. ====
  365. There are two pop-up menus. Clicking with mouse button 2 on the edit controls
  366. (Subject entryfield and Keys/Comments fields) you will get the most complete
  367. menu. The menu you'll get by clicking elsewhere will not have the Edit
  368. submenu.
  369.  
  370. Submenu File
  371. Select->Browse       Show/hide drive/directory/file selection window
  372. Select->Select all   Selects all files in the current directory
  373. Select->Deselect all Deselect all files
  374. Select->Mask         Allows to specify a selection mask throuh the Mask selection
  375.                      dialog. See Mask selection section for more details.
  376. Refresh              Refresh the contents of the drive/directory/file selection
  377.                      window.
  378. Save attributes      Saves the current attributes.
  379. Report               See Preferences: [Report page]
  380. Find                 Not yet implemented
  381. Exit                 Terminate the application.
  382.  
  383. Submenu Options
  384. General Preferences  See the Preferences section
  385. Font                  "   "       "         "
  386. Read only mode        "   "       "         "
  387.  
  388. Submenu Edit
  389.    Undo              (not yet implemented)
  390.    Cut-Copy-Paste    work as usual
  391.    Clear             delete selected text
  392.    Import            will import file description from the selected source
  393.                      to the target that originated the pop-up menu.
  394.                      If there are multiple file selected and the application
  395.                      is not in "Read only" or "View only" mode, file descriptions
  396.                      will automatically be saved in the EAs of all selected files.
  397.                      For instance, if you have a directory with archived files
  398.                      you downloaded from internet, you can automatically import
  399.                      all file_id.diz descriptions (if available) in the archives
  400.                      EAs by selecting all files (from the pop-up menu:
  401.                      File->Select->Select all) and then selecting
  402.                      Edit->Import->File_id.diz from the Subject or Comment pop-up
  403.                      menu.
  404.  
  405. Submenu Help         not yet implemented
  406.  
  407.  
  408. Mask selection dialog
  409. =====================
  410.  
  411. You can select multiple files by this dialog. You can either enter the file name
  412. in the entryfield part of the combo box or select from the list box the file
  413. specifics that suits your need.
  414. Items can be added or deleted to the list box through the Store and Delete
  415. buttons. Data are stored in the application INI file.
  416. Clicking on OK will confirm the file selection. Clicking on Cancel or closing
  417. the dialog won't perform any action in the file list box.
  418.  
  419.  
  420. Known limitations
  421. =================
  422. -1) The inner controls will not be resized correctly if the maximized size
  423.     of the windows is limited by the "Warp Center" of OS/2 4.x.
  424. -2) I've used standard "list box" controls so there could be problems if
  425.     you have large amounts of files in your folders (32765 files with
  426.     OS/2 Warp 3 or 4 - I'm not sure about OS/2 2.x).
  427. -3) The code has not yet been optimized, neither for size not for speed.
  428.     The program works very well with my P100 machine, and I think the speed
  429.     could be acceptable even with a 386 (let me know if you have any problem).
  430.     It still does all work in a unique thread, so some operation like
  431.     modifying attributes of a large number of file, will not allow you to
  432.     interact with the system until the end of it.
  433.     The program has not been packed, but if you have warp 3 or 4 you could
  434.     shrink it up by LXLITE. (It is a free utility by Andrew Zabolotny.
  435.     You can download it from:
  436.     hobbes.nmsu.edu/pub/os2/util/archiver/lxlt118.zip).  
  437. -4) Since control size depends on the system default font size rather than
  438.     on the font used by the controls or by their owner window, the program
  439.     window could be too large with the default system font.
  440.     In a future release I'll add a routine to make all controls automatically
  441.     resize themselves according to the size of the font used in the window.
  442. -6) Setting automatic import or importing descriptions for multiple files
  443.     will often display some annoying error message box. In future I'll
  444.     include a status bar for messages regarding the current file and a log
  445.     window when operations are performed on multiple files.
  446.  
  447. What will be in the future releases?
  448. ====================================
  449. I will implement the still missing features as soon as possible.
  450.  
  451. For any suggestion or bug report write to me:
  452.  
  453. Alessandro Cantatore - Team OS/2 Italy
  454. email:    alexcant@tin.it
  455.           alex.cant@iol.it
  456. fidonet:  2:335:705/2